home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / dev / amos / apme14.lzh / readme.doc < prev    next >
Text File  |  1995-09-25  |  9KB  |  284 lines
  1.  
  2.  
  3.              AMOSPro 1.12/2.00  Multi-Envoironment Patch V1.4
  4.              ------------------------------------------------
  5.  
  6.            Written By Paul Hickman (ph@doc.ic.ac.uk) - June 1994
  7.     Additions and Amos Patch by Mark deJong and Darryl Lewis -September 1995
  8.            ----------------------------------------------------
  9.  
  10.       Adapted from AMOS Multi-Envoironment Patch V1.1  for AMOS 1.36
  11.       --------------------------------------------------------------
  12.  
  13.  
  14.  
  15. IMPORTANT
  16. =========
  17.  
  18.     APME V1.2 contained a bug which made Amospro V2.00 crash. Before
  19.     installing this fixed version, copy your original unpatched AmosPro
  20.     V2.00 file over the patched AmosPro file in you AMOSPro_System:
  21.     directory.
  22.  
  23.     APME V1.3 did not work on all builds of the AMOSPro file. 
  24.  
  25. Disclaimer
  26. ----------
  27.  
  28.         The program PatchAMOSPro will modify your AMOSPro program.
  29.         I take no resposibility if it wreck's it - make sure you
  30.         have a backup.
  31.  
  32.         I also take no responsibilty explicitly, implicity, and all
  33.         that other legal crap if something else that you didn't want
  34.         to happen does, 'cos i'm still in an irresponsible mood!
  35.  
  36.  
  37.  
  38. Distribution
  39. ------------
  40.  
  41.         Whatever - modify / copy / hack to pieces. Please post me
  42.         back any improvements - these are among my first E programs,
  43.         so the sources can probably be improved.
  44.  
  45.  
  46. Files
  47. -----
  48.  
  49.         Install_AMOSProMultiEnv        The installer script
  50.  
  51.         AmosIcon                       An Icon To Load AMOSPro.
  52.         GetAMOSProEnv                  A Program to select an envoironment.
  53.         PatchAMOSPro                   A Program to modify AMOSPro file.
  54.         Readme.Doc                     This File.
  55.         PatchAMOSPro.old               The old modification program
  56.         
  57.  
  58.         GetAMOSProEnv13.e              The Sources
  59.         PatchAMOSPro.amos
  60.         PatchAMOSPro.e.old            
  61.  
  62.  
  63. Requirements
  64. ------------
  65.  
  66.         AMOSPro V1.12 or V2.00 - NOT AMOSPro V1.0, or any other version.
  67.         2 bytes are overwritten in the AMOSPro program file - they may
  68.         be at a different location in different versions of AMOSPro.
  69.  
  70.         ReqTools Library - Any version will probably work - I only
  71.         use the file requester.
  72.  
  73.  
  74.  
  75.  
  76. Overview
  77. --------
  78.  
  79.         When you load AMOSPro, it searches for one of the files:
  80.  
  81.         S:AMOSPro_Interpreter_Config
  82.         AMOS_ProSystem:S/AMOSPro_Interpreter_Config
  83.  
  84.  
  85.         And loads the first one it finds. These files contain your
  86.         AmosPro interpreter configuration (Suprisingly enough) which
  87.         contains the loaded extensions, number of bobs, copperlist
  88.         buffer size etc. Running PatchAMOSPro modifies AMOSPro so it
  89.         searches the files:
  90.  
  91.         T:AMOSPro_Interpreter_Config
  92.         S:AMOSPro_Interpreter_Config
  93.  
  94.  
  95.         GetAMOSProEnv opens a reqtools filerequester in the directory
  96.         AMOSPro_System:APSystem/Interpreter_Configs (Which is created
  97.         by the installer scripts). Initially this contains the file
  98.         Default.config. Whatever file you select here is copied to
  99.         T:AMOSPro_Interpreter_Config before AMOSPro is run hence 
  100.         becoming the configuration you use for that session.
  101.  
  102.  
  103.  
  104.  
  105.  
  106. Installation
  107. ------------
  108.  
  109.  
  110.         Just double click the installer icon and select your AMOSPro
  111.         System directory / disk.
  112.  
  113.         AMOSPro will be patched, the configs directory created, your
  114.         current configuration copied into it as the default, the
  115.         GetAMOSProEnv program is copied into the AMOSPro_System directory,
  116.         along with an iconx script to load AMOSPro via the selector.
  117.  
  118.  
  119.         AMOSPro can still be run with it's default config in S: by
  120.         double clicking on it's original icon.
  121.  
  122.  
  123.  
  124.  
  125. Usage
  126. -----
  127.  
  128.         Double click on the "Amos Env-Loader" icon. Select An 
  129.         Envoironment.
  130.  
  131.  
  132.  
  133.  
  134. Multi-Selection
  135. ---------------
  136.  
  137.         To load AMOSPro with an AMOS program in the editor & run the
  138.         program, select the program's icon, then shift double-click
  139.         the "Amos Env-Loader" icon.
  140.  
  141.  
  142.  
  143.  
  144. Toolmanager
  145. -----------
  146.  
  147.         AMOSPro Multi-Env works great from a toolmanager dock window, or
  148.         toolmanager App Icon. Simply create an exec object to the Amos
  149.         script, of type CLI, which has the "Arguments" box checkmarked.
  150.         Then create an image object, and a dock / icon object to launch
  151.         it.
  152.  
  153.         To run AmosPro from toolmanger, click on the dock icon / app icon.
  154.         To load a file into AmosPro from toolmanager, drop the file on the
  155.         dock icon / app icon.
  156.  
  157.  
  158.  
  159.  
  160. Modifing Configurations
  161. -----------------------
  162.  
  163.         To modify a configuration, select "Set Interpreter" from the config
  164.         menu, then select "Load other configuration". Goto the directory
  165.         "AMOSPro_System/APSystem/Interpreter_Configs" and choose a
  166.         configuration to modify. Change it, then save it to a new file in
  167.         the same directory. End the filename in ".config" so it matches
  168.         the filer pattern "#?.config" in the GetAMOSProEnv filerequester.
  169.  
  170.         To not save/load the default configuration as this is not used
  171.         when loading AMOSPro via the Env-Loader. Instead, the 
  172.         Default.Config file is used for the default configuration.
  173.         
  174.  
  175.  
  176. Notes / Hints
  177. -------------
  178.  
  179.         You will need the program Install. If you don't have it already,
  180.         many versions of it are available on Aminet.
  181.    
  182.         The AMOS 1.36 compiler uses the envoironment specified by it's
  183.         own configuration files - Not the envoironment you select
  184.         with this filerequester. I don't know what the AMOS Pro compiler
  185.         does, as I don't have it.
  186.  
  187.  
  188.         Get toolmanger, and use it - it's easily the best way to
  189.         load AMOSPro. If you do this set the save with icons option
  190.         in the configuration editor so your programs have
  191.         icons to drop on the toolmanager dock/app icon.
  192.  
  193.  
  194.  
  195. Credits
  196. -------
  197.  
  198.         GetAMOSProEnv, was written in E. Thanks
  199.         go to Wouter van Oortmerssen for a rather nice language.
  200.  
  201.         Reqtools.library is written by Nico Francois.
  202.  
  203.         Toolmanager was written by Stefan Becker.
  204.  
  205.  
  206.         The E language, Reqtools & Toolmanager are all available
  207.         on aminet. Thanks also to whoever it was that posted to the
  208.         AMOS mailing list about removing/installing extenions for
  209.         the inspiration!
  210.  
  211.  
  212.  
  213.  
  214. Changes: AMOSMultiEnv V1.0 ---> V1.1
  215. ------------------------------------
  216.  
  217.     Both E programs now use exception handling for error
  218.     recovery, and print errors to requesters, not the command line.
  219.  
  220.     PatchAMOS can now accept the AMOS file to patch as a
  221.     command line argument.
  222.  
  223.     Both programs now accept the argument in double quotes.
  224.  
  225.     The installer script now creates a customised launching
  226.     script for your system - there is no "Amos" file in the
  227.     distribution anymore.
  228.  
  229.     The cancel button in the filerequester now cancels the
  230.     Loading of AMOS.
  231.  
  232.     Shift-Selected / Toolmanager / CLI arguments to the AMOS
  233.     script are passed on to AMOS1.36 so you can autoload & run
  234.     programs.
  235.  
  236.  
  237.  
  238.  
  239. Changes: AMOSMultiEnv V1.1 ---> AMOSProMultiEnv V1.1
  240. ----------------------------------------------------
  241.  
  242.     All file directory names in Installer Script, Readme file
  243.     and E programs changed to AMOSPro versions.
  244.  
  245.     PatchAMOSPro now changes the relevant bytes for AMOSPro V1.12
  246.  
  247.     The installer script now creates a directory for configs, and
  248.     copies your current default into it.
  249.  
  250.  
  251.  
  252.  
  253. Changes: AMOSProMultiEnv V1.1 ---> AMOSProMultiEnv V1.2
  254. -------------------------------------------------------
  255.  
  256.     Title of error requesters changed.
  257.  
  258.     Now works for Amospro V2.00 as well as V1.12.
  259.  
  260.  
  261.  
  262.  
  263. Changes: AMOSProMultiEnv V1.2 ---> AMOSProMultiEnv V1.3
  264. -------------------------------------------------------
  265.  
  266.     It turns out I was lying last time - it didn't work for AMOS V2.00.
  267.     This is now fixed.
  268.  
  269.     Memory allocation bugs have been fixed in both E programs. It used to
  270.     "forget" the filename between you selecting it, and it opening it
  271.     before - now it doesn't
  272.  
  273.     AMOSPro V2.00 searched for the files in S: first, then T:, so you
  274.     had to delete the copy in S: for it to work. This is now reversed -
  275.     T: is searched first, so you can still keep a copy in S:
  276.  
  277.  
  278. Changes: AMOSProMultiEnv V1.3 ---> AMOSProvMultiEnv V1.4
  279. --------------------------------------------------------
  280.  
  281.     Some versions of AMOSPro use different cases for specifing directories.
  282.     A replacement patch written in Amos, and compiled, replaces the 
  283.     PatchAMOSPro that was written in E. 
  284.